hilitedButtonName

Type

property

Summary

Specifies which button in a group is currently highlighted.

Syntax

set the hilitedButtonName of <group> to <buttonName>

Description

Use the hilitedButtonName property to change the current setting in a radio-button cluster.

The hilitedButtonName specifies which button in a group is currently highlighted. If the hilitedButtonName of a group is empty, none of the buttons in the group is currently highlighted.

Setting the hilitedButtonName of a group sets the hilite property of the rest of the buttons to false.

The hilitedButtonName property is most useful in radio-button clusters. In a radio-button cluster, only one button can be highlighted at once: clicking another button unhighlights the first one. The radioBehavior property of a group of buttons specifies whether they act as a radio-button cluster.

The hilitedButton, hilitedButtonName, and hilitedButtonID properties all refer in different ways to the same button. When any of them changes, all of them change.

Examples

set the hilitedButtonName of group "Options" to "Help"

Related

command: hilite, group

glossary: property, highlight, radio button

keyword: button

object: button

property: family, hilite, hilitedButtonID, name, hilitedButton, autoHilite, radioBehavior

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile